home *** CD-ROM | disk | FTP | other *** search
/ The Macintosh Demo Applications CD / Apple-MacintoshDemoApplicationsCD-1.0-1992.iso / More Information / GQL V3.0 / Demo Notes (text only) < prev    next >
Text File  |  1992-01-20  |  38KB  |  597 lines

  1. This is a text-only version of the GQL/User V3.0 Demo Guide.  If you would like to receive a printed version (with illustrations) please contact Andyne and we will be happy to send you one.
  2.  
  3.  
  4. 552 Princess Street
  5. Kingston, Ontario
  6. K7L 1C7
  7. (613) 548-4355
  8. 1-800-267-0665 
  9.  
  10. GQL, GQL/Admin, GQL/Design,  GQL/User are trademarks of Andyne Computing Limited. 
  11. Apple, AppleTalk, Laserwriter, Macintosh, MacTCP, and HyperCard are registered trademarks of Apple Computer, Inc. Finder and MultiFinder are trademarks of Apple Computer, Inc.
  12. INGRES is a trademark of Ask/Ingres Corporation.
  13. ORACLE and SQL*Net are registered trademarks of Oracle Corporation.
  14. Wingz is a trademark and Informix is a registered trademark of Informix Software, Inc.
  15. VAX, Rdb, VMS, DECnet, and RMS are trademarks of Digital Equipment Corp.
  16. DB2, SQL/DS, AS/400, and IBM PC are registered trademarks of International Business Machines Corporation.
  17. UNIX is a registered trademark of AT&T.
  18. Tandem and NonStop are trademarks of Tandem Computer, Inc.
  19. Post-it is a registered trademark of 3M.
  20. SYBASE SQL Server is a trademark and SYBASE and DB-Library are registered trademarks of Sybase, Inc.
  21. Ethernet is a registered trademark of Xerox Corporation.
  22. AlisaTalk is a registered trademark of Alisa Systems Inc.
  23. SequeLink is  a trademark of TechGnosis Inc. 
  24. DBC/1012, and Teradata are registered trademarks of Teradata Corporation.
  25. Microsoft is a registered trademark of Microsoft Corporation.
  26.  
  27. All other trademarks are those of their respective owners.
  28.  
  29. Copyright © Andyne Computing Limited 1991.
  30. 552 Princess St., 2nd Floor.
  31. Kingston, Ontario
  32. Canada K7L 1C7
  33. All rights reserved. 
  34.  
  35.  
  36. Printed in Canada, January 1992.
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46. Table of Contents
  47.  
  48.  
  49.  
  50. GQL/Demo Package Overview    4
  51. Installation    5
  52. Getting Started    6
  53. Ad hoc Query Tool or EIS Application?    7
  54. EIS (Executive Information System)    8
  55. Integrated Report Module    12
  56. Ad hoc Queries    13
  57. The Results Window    15
  58. Qualifications and Sorting    17
  59. Full Menus    18
  60. Data Values    18
  61. Using Relationships    21
  62. Saving Queries (Query Documents)    22
  63. Executive Buttons    23
  64. Qualification Prompts    26
  65. Getting started with System 7.0    27
  66. Publish/Subscribe (using GQL and Excel)    28
  67. Other Features    31
  68. Building GQL Data Models    32
  69. GQL - The Corporate Data Access Solution    32
  70.  
  71.  
  72.  
  73. Appendix A - The GQL Product Family    33
  74. Windows 3.0    34
  75. Unix/Motif    34
  76.  
  77. GQL/User Demo Overview
  78.  
  79. The GQL/User Demo package contains a special version of the GQL/User application that will allow you to become familiar with GQL concepts and to demonstrate how GQL can be used to access host database information.  The demo version differs from the actual product in one major way - you  don’t need to be connected to the host computer while running the demo. In other respects, using the GQL/User Demo package is just like using GQL/User.
  80.  
  81. If you are not familiar with the GQL family of products you may wish to glance at Appendix A for a brief description of the product family.
  82.  
  83. These notes will take you through a sequence of steps that introduce GQL/User features to you.  Stored results are used to provide data for all of the queries described in this booklet. You may want to deviate from the scripted session. However, since the demo is not accessing a real database management system you won't get actual data back for every query you try.  Whenever you generate a query that has no corresponding stored results, GQL will provide simulated data and notify you with the following dialog box.
  84.  
  85.  
  86.  
  87. 
  88.  
  89. If you stray from programmed queries in the Demo version
  90.  
  91.  
  92.  
  93.  
  94. Installation
  95.  
  96. The GQL/User Demo is distributed on a single high-density (1.4 MB) diskette, but is recommended that you run the demo from a hard disk.  To install, simply drag the folder called GQL Demo Folder onto your hard disk.
  97.  
  98. 
  99.  
  100. Contents of the GQL/User Demo Disk
  101.  
  102. Please keep the contents of GQL Demo Folder together as the demo application requires access to the data files to present query results.
  103.  
  104.  
  105. 
  106.  
  107. Contents of the GQL Demo Folder
  108.  
  109. Note:    If you see the message: "This disk is unreadable: Do you want to initialize?", you are probably trying to install the demo on a system that can't read 1.4MB floppy disks.  Use another system to copy the demo onto two 800KB floppy disks, or give us a call and we will send you  800KB floppy disks.
  110. Getting Started
  111.  
  112. Start the demo application by double-clicking on the document USA Sales Information.  This will launch the application GQL/User (demo) and open the USA Sales Information. 
  113.  
  114. The GQL desktop window will appear as shown in the following figure.
  115.  
  116.  
  117. 
  118. The USA Sales Information  Model 
  119.  
  120. The data model window contains data objects, relationships, executive buttons, and ornaments.  The square and rectangular icons are data objects that represent tables, or combined tables, that hold information in the database.  Data objects are connected to each other by lines that contain relationship (diamond shaped) icons.  The relationships guide the user through the database so that information can be extracted from more than one data object.  The relationships are named in a manner that helps the user to understand how the information in one data object can be combined with information from another data object.  However, in some cases you may choose not to show the relationship names, or even display the relationship icons,  if you feel it isn't required.  In this example the customer data object is related to the order data object through the placed relationship.  The order data object is related through the sold relationship to the salesman data object.  This approach to the data model guides the user in getting information about the customer and the salesman by showing the different ways that the information can be related.  The user formulates queries by using the data objects and relationships.
  121.  
  122. Executive buttons are used to provide easy push button access to information in the corporate database.  Each button can be associated with a stored query (with optional parameters), and an output (a results window, a report, another application, or a file), or can be used to activate another window.  It is possible to have buttons that directly activate other applications such as Microsoft Excel to have the data charted or placed into a spreadsheet.  Stored queries can be formulated by the user, or created for the user by the MIS staff. 
  123.  
  124. Ornaments are text or graphic objects that are placed on the data model as titles, borders, comments, highlights, etc. in order to improve the layout.
  125.  
  126.  
  127. Ad hoc Query Tool or EIS Application?
  128.  
  129. GQL does an excellent job at both!  The GQL product family includes a special tool (GQL/Admin) for customizing the interface to meet your needs.  Using GQL/Admin, the graphical data model is created, attributes can be renamed to make them more meaningful for the user, customized sets of executive buttons can be created, and the overall layout is defined.  The resulting GQL document can be setup as a multi-level executive buttons interface, and ad hoc query interface, or both.  The data model can be hidden from users if you wish to create a push button only user environment.  GQL has the unique capability of allowing you to customize the interface to suit the different needs and skill levels of different users.
  130.  
  131. The USA Sales Information document is has a combination of both ad hoc and EIS (Executive Interface System) styles.  It is designed to give you a feel for the overall product.  This demo guide starts off by taking you through an EIS style interface, shows you the integrated report module, and then moves on to ad hoc queries and executive buttons.  Once you have gone through the demo you will also want to look through the menus and try some experiments to discover some of the other powerful features in GQL.
  132. EIS (Executive Information System)
  133.  
  134. GQL can also be customized to provide an executive interface system (EIS) style interface.  This demo includes a drill-down interface that demonstates some of these capabilities.
  135.  
  136. To begin, return to the USA Sales Information window and press the executive button with the map of the USA on it, 
  137. 
  138. the following window will appear.
  139.  
  140. 
  141.  
  142. Sample EIS Interface
  143.  
  144. The map of the USA is divided into three sales regions.  There are several executive buttons displayed that either take you to other windows, or issue stored queries.  Pressing the executive button for a region will 'zoom in' on that region by moving to another window that has regional details.  In this example we will look at the Western sales region.
  145.  
  146. Press the button called Western Region,
  147. 
  148. the following window will appear.
  149.  
  150. 
  151.  
  152. Western Region for USA Sales Information
  153.  
  154.  
  155. A map of the western sales region is shown on the left side of the window.  The small USA map in the upper right corner has executive buttons with arrows that are used to switch to other regions or return to the main USA map.  The button in the lower right corner is used to switch back to the main window for ad hoc queries   The other two executive buttons issue stored queries.  We will use the Customer List button to 'drill-down' to specific information about customers in San Jose, California.  GQL provides an extensive prompting facility that allows you to enter qualifying information before a query is issued.
  156.  
  157. Press Customer List button,
  158. 
  159. The following dialog will appear.
  160. 
  161.  
  162. User Prompt for Qualifying Information
  163.  
  164. This dialog allows you to enter additional information that qualifies or restricts the information that will be retrieved when you submit the query.  You can enter information by typing directly into the prompt boxes, or by using data values to select from a list of known values. The values that are initially displayed in the prompt boxes are the last values that were entered.  We will use two different ways to access stored values for the prompts.  A button with a down arrow is located at the right of the State prompt.  Press down and hold the mouse button while the cursor is over this button, and a pop-up list of value will appear as follows:
  165. 
  166. Choose CA (for California) from the list.  The value for the State prompt will be set to CA and the value for the City prompt will be highlighted (in preparation for your next entry).  In the next example we will actually issue a query to load a list of valid values from the database.  The query that retrieves the list of values for City uses the State information you just entered to only retrieve names of cities in California that are stored in the database.
  167.  
  168. With the City prompt value highlighted, press the Data Values... button..  The following list will appear.
  169. 
  170.  
  171. Data Values for Cities in California
  172.  
  173. Select San Jose from the list and press Insert (or double-click on San Jose).  Now that you have entered the qualifications, press the OK button and the query will be submitted.  The results will be displayed as follows.
  174.  
  175. 
  176.  
  177. Results for San Jose, California
  178. (with columns expanded)
  179.  
  180. You have just completed your first query!  Using the facilities provided by GQL you were able to 'drill-down' to the specific information we wanted.
  181.  
  182. Let's take a look at reports, then we'll move on to ad hoc queries.
  183.  
  184. Return to the USA Sales Information window by pressing the executive button that has a data model diagram on it,
  185. 
  186.  
  187. or by selecting USA Sales Information from the Windows menu.
  188.  
  189. Integrated Report Module
  190.  
  191. GQL’s report module features an interactive (WYSIWYG) interface that permits end users to create their own reports using up-to-the-minute database information. Frequently used reports can be stored with executive buttons.
  192.  
  193. Press the executive button with the picture of a report on it, 
  194. 
  195. a stored query will be issued.  After the results are returned, the following report will be displayed.
  196.  
  197. 
  198.  
  199. USA Sales Summary Report
  200. Ad hoc Queries
  201.  
  202. The USA Sales Information data model  describes a database containing customers, orders and salesmen.  Let’s make your first ad hoc query to find out who the customers are.
  203.  
  204. If you are not already at the main ad hoc query window, select USA Sales Information from the Window menu.
  205.  
  206. Choose New Query from the Query menu.
  207.  
  208. Double click on the customer icon
  209. 
  210. to open the customer attribute window.
  211.  
  212.  
  213. 
  214.  
  215. The customer Attribute window
  216.  
  217. You will want to list the customer names and their cities.  Click on the attribute labeled Name  Note how Name is changed to bold face and a "•" character is put in front to indicate that this field will be included in the results.  Click on the attribute labeled City to include it in the query as well. 
  218.  
  219. Now your query is ready!  Submit the query by pressing the Submit Query button at the lower left corner of the window (or by choosing Submit Query from the Query menu).
  220.  
  221.  
  222. 
  223.  
  224. Query ready to be submitted
  225.  
  226. GQL will create a Query Results 1 window and as the data is returned from the host it will fill the window.  The actual number of the results window will vary depending on how many queries you have tried in the previous section of the demo.  (The initial width of the columns in the results window you get back will be narrower than shown below.  See next section to resize columns.)
  227.  
  228.  
  229. 
  230.  
  231. Query Results for the first query
  232.  
  233. Congratulations, you’ve formulated your first ad hoc query using GQL!
  234.  
  235. The Results Window
  236.  
  237. The data for your query is displayed in the query results window.  This window presents the data in a spreadsheet-like form.  Individual cells or groups of cells can be selected directly from the query results window for copying to other applications through the Macintosh clipboard facility.  
  238.  
  239. Before sending data to another application, you may want to rearrange the data or manipulate it in various ways.  Many operations on the local query results are supported by GQL.  For example, the data in the results window can be sorted locally (without going back to the host database), ranges taken on the data, columns reordered or completely hidden, or the columns resized.
  240.  
  241. To resize a column, simply move the cursor to the dividing line between a column and its neighbor.
  242. (The cursor will look like this:  )
  243.  
  244. Drag the line right to widen the column, or left to narrow the column.
  245.  
  246. An alternative method to set the column width is to select a column and then choose Column Width… from the Results menu.  A dialog is displayed, that allows you to enter the desired width or select an option to automatically set the width to the widest data  item in the column.
  247.  
  248. Other options are available with Full menus enabled (Full menus are discussed later).
  249.  
  250. The Filter button located at the bottom left corner of the query results window activates the local operations for sorting, range selection and computing minimum, maximum, sum and averages on columns.
  251.  
  252. Press the Filter button to open the Filter dialog.
  253.  
  254. 
  255.  
  256. The Filter dialog
  257.  
  258. Press the Sort... button to open a dialog for selected the sort order.
  259.  
  260. 
  261.  
  262. The Sort dialog
  263.  
  264. Double click on City in the Selected Columns list (City will move to the Sort Order column), and then click on the OK button.  This specified that the data should be sorted in ascending order according to City. The filter dialogs will disappear, and a second results window, Query Results 1.1 will be displayed.  GQL creates a second window so that you can still refer to the original results from the query.  This way you can feel free to manipulate the data locally without concern of losing the original data.
  265.  
  266.  
  267. 
  268.  
  269. Results sorted by City
  270.  
  271. The data in the results window can be saved to a file and subsequently read into other applications.  You can even arrange to associate the saved data with another application, so that double-clicking the document will open the desired application.
  272.  
  273.  
  274. Qualifications and Sorting
  275.  
  276. As is often the case with an ad hoc query, you may decide to change the query once you’ve seen the data.  In this case you may decide you want to have the companies in alphabetical order, and you only want to look at customers from Illinois or Indiana.
  277.  
  278. An important feature of GQL is its support for incremental query formulation.  You can go back to the query you just submitted and change it to reflect your new goals.  
  279.  
  280. Let’s go back to the customer attribute window.  The Window menu lists all the GQL windows currently open.  Choose customer from the Window menu.
  281.  
  282. [Note: if customer doesn’t appear in the list then you may have closed the window earlier.  In that case, select the window named USA Sales Information to get back to the data model window.  Double Click on the customer icon to reopen the customer attribute window.]
  283.  
  284. To the right of each attribute name are four buttons.  The fourth column of buttons (at the far right) are the Sort buttons.  Click the one beside Name to sort the results by Name.  A numeral 1 will appear in the button to indicate that this is the primary sort field (i.e. sort the results so that the companies come out in alphabetical order).  
  285.  
  286. 
  287.  
  288. Extra options added to query
  289.  
  290. To restrict the results to those companies in Illinois or Indiana, we will add two qualifications (restrictions) to the query.  
  291.  
  292. The second column of buttons (in the middle) are the Qualify buttons.  Click the one beside State to indicate that you want to add a new qualification.  A check mark will appear in the button to indicate that there is a qualification on the field. 
  293.  
  294. At the bottom of the customer attribute window a qualification node for state will be displayed and the text insertion point is active.  Simply type IL,  the state code for Illinois. (This must be upper case.)
  295.  
  296. But we wanted two conditions (Illinois or Indiana), so click the qualify button beside state again.  Type IN,  the state code for Indiana. (Also in upper case.)
  297.  
  298. There is one more step.  Right now the qualification requires that the customer’s state code be IL and IN, we want IL or IN.  Simply click on the word and between the two qualification nodes, it will change to or.
  299.  
  300. Now press the Submit Query button to get the new results!
  301.  
  302.  
  303. Full Menus
  304.  
  305. GQL can be set to use either short menus or full menus.  Short menus provide a simplified interface that meets the needs of many users, but in order to use some of the advanced features in GQL you will need to enable full menus.  Before proceeding with the next section of the demo, select Full Menus from the Edit Menu.
  306.  
  307.  
  308. Data Values
  309.  
  310. We’ll start a new query.  First close the results window from the previous query (click on the go away box), then select New Query from the Query menu.  This clears out the previous query so we can start from scratch.
  311.  
  312. Now  let’s get  information on Nicolo Corporation.  
  313.  
  314. Double click the customer data object icon to open the customer attribute window.  Choose Name, Address 1, City, and State as the attributes for the query.  
  315.  
  316. If we submit the query now we’ll get all the customers - not just  Nicolo Corporation.  Let’s put the qualification on company name by clicking on the Qualify button beside the Name attribute.  Type Nicolo Corporation.
  317.  
  318.  
  319. 
  320.  
  321. First attempt at the qualification
  322.  
  323. Press the Submit Query button.  The query returns with an alert saying that no data was found for your query.
  324.  
  325.  
  326. 
  327.  
  328. When there are no results for your query
  329.  
  330. Sometimes you want to put a qualification on a query but you don’t know the value exactly as it occurs in the database.  Nicolo Corporation may not be the exact name as it appears in this database.  We’ll use the Data Values facility to get the value as it is in the database.  
  331.  
  332. Use the Window menu to reactivate the customer attribute window.  (There is an entry in the Window menu 'customer'. This is the customer attribute window.)  Select the text of the qualification (leaving the quote marks out of the selection).  
  333.  
  334.  
  335. 
  336.  
  337. Select the qualification to be replaced
  338.  
  339. Type the backspace or delete key to delete the qualification Nicolo Corporation.  
  340.  
  341.  
  342. 
  343.  
  344. Clear the previous qualification value
  345.  
  346. Select Insert Data Values… from the Edit menu.  The data values dialog will appear. 
  347.  
  348.  
  349. 
  350.  
  351. Data Values dialog
  352.  
  353. Click the Load Data button.  The customer names will fill the data value list.  Type N to scroll the list down to the Ns.  Select the one for Nicolo Corporation.
  354.  
  355.  
  356. 
  357.  
  358. Select the correct value
  359.  
  360. Click the Insert button to have the value copied into the customer name qualification.  Now we see why our first attempt didn’t work - the actual value in the database was Nicolo Corp.
  361.  
  362.  
  363. 
  364.  
  365. The correct qualification
  366.  
  367. Now press the Submit Query button, and voilà, the information on Nicolo Corporation!  The values loaded for the company names will be cached in GQL until you quit from the application, so if you need the company name again you won’t have to press the Load Data button.
  368.  
  369.  
  370. Using Relationships
  371.  
  372. This query now gets the information we wanted about a  particular customer.  Let’s now find out about the orders that this customer has placed.  Reactivate the USA Sales Information window.  There is a relationship between customer and orders called placed.  Click once on the placed icon ( the diamond).  The connecting line from customer to placed and the line from placed to orders are highlighted.  We have just activated the relationship between customer and orders.
  373.  
  374.  
  375. 
  376.  
  377. An activated relationship
  378.  
  379. Now double-click on order.  (If you forget to activate the relationship before you try to open another data object,  GQL warns you that you have forgotten the relationship.  Simply Cancel the alert and go back to put the relationship in.)  The order attribute window is open.  Select Amount and Date Required  (Notice that you’re dealing with attribute names like Date Required rather than cryptic database names like req_date .)
  380.  
  381. Now press the Submit button,  and  the information on Nicolo Corporation now includes the current orders.
  382.  
  383.  
  384. Saving Queries (Query Documents)
  385.  
  386. The query we just executed may be one that you want to be able to use again in the future.  Let’s save it so we can use it later.
  387.  
  388. Select Save Query… from the Query menu.  Specify a name for this query  (say Nicolo) and press the  Save button.  This will save the query as part of the USA Sales Information document. Should you want to exchange this query with another user, or provide this query as a Data Access Manager (DAM) query document to another application that uses the Data Access Manager High Level Interface, you could have chosen to save the query in a separate document (the To File button).
  389.  
  390. Now the query is available for use at anytime in the future.  Simply choose Load Query… operation from the Query menu to have the saved query reloaded.  Of course the query can be edited or extended once it is reloaded.  You’ll have to save it again if you want the edited query to be stored in place of the original.
  391.  
  392. [Note: In the demo version of GQL, the ability to save documents has been disabled.  Any queries you save will only be available during the current session.]
  393.  
  394.  
  395. Executive Buttons
  396.  
  397. Saved queries are very useful but some queries are used so regularly that you may want even easier access to them.  GQL’s executive buttons provide a convenient way to organize and access your standard queries.
  398.  
  399. The USA Sales Information has several executive buttons already defined.  Return to the USA Sales Information window.
  400.  
  401. Press the button labeled Customer List.  GQL will load the query associated with this button, and Submit the query.  The results will be returned in a query results window.
  402.  
  403. Now let’s create a button for our own query.  Return to the USA Sales Information window.
  404.  
  405. Select Create Button from the Layout menu.  The create button dialog will appear.
  406.  
  407.  
  408. 
  409.  
  410. Creating an Executive Button
  411.  
  412. There are three steps in creating an executive button:  First, specify the appearance of the button,  Second, specify the linkage to a query or window, and third, specify the output destination for the results.
  413.  
  414. We’ll create a Text button.  Press the Edit Text... button.
  415.  
  416.  
  417. 
  418.  
  419. Specifying the button label
  420.  
  421. Type Nicolo Orders, and select the font, size, alignment, and style that you want.  Press OK to return to the button dialog.
  422.  
  423. The Linkage is set to Query by default.  To select the actual query, press and hold down the mouse button while the cursor is over the box to the the right of Select Query:.  A pop-up list of the available queries is displayed.  Choose the Nicolo query you created earlier.
  424.  
  425.  
  426. 
  427.  
  428. Choose the query
  429.  
  430. Leave the Action section for now - the results will be sent directly to a GQL query results window.
  431.  
  432. Press OK to return to the USA Sales Information window.  
  433.  
  434. You will find the button you have just created selected in the window.  Drag it to a convenient location, then press the mouse button when it is not over the executive button in order to deselect the button.  It’s ready to use!  Just press it to execute the query.
  435.  
  436.  
  437. 
  438.  
  439. The new executive button
  440.  
  441. [Note: If you want to edit the button specification, or move it elsewhere in the diagram, select Edit Mode from the Layout menu.  While in Edit Mode you can access the button dialog by double clicking the button, and move it by dragging it with the hand cursor.]
  442.  
  443. Qualification Prompts
  444.  
  445. The query we created and saved with a button was useful for getting the sales to Nicolo but not as useful for other companies (although it can always be loaded, the qualification edited, and the revised query submitted).  Let’s generalize the query so that it will allow us to enter the company name whenever the query is selected.  We will use GQL’s Qualification Prompt facility.
  446.  
  447. There’s no sense starting from scratch, let’s load the Nicolo query.  Select Load Query… from the Query menu.  Select Nicolo from the list and press Load.  The query is now loaded and ready for modification; the query window named Query: Nicolo is displayed.  Return to the USA Sales Information window. Double-click on the customer icon to open the customer attribute table.  In the qualification area select the text Nicolo Corp.  Press backspace or delete to clear the text and just leave the quote marks.  Now select Insert Prompt… from the Edit menu..
  448.  
  449.  
  450. 
  451.  
  452. The Qualification Prompt dialog
  453.  
  454. We’ve already created the prompt for you so select the Prompt Id company.  Press the Insert Prompt button to have the special qualification prompt inserted into the qualification for you.
  455.  
  456.  
  457. 
  458.  
  459. The qualification with prompt token
  460. Now test the query by pressing the Submit Query button.  GQL prompts you for the company name.  Obviously you could type the name if you know it,  but it’s easier to use the Data Values button to get at the values from the database.  Use Data Values to select Acme  Manufacturing Co.  Press the OK button to execute the query and get Acme’s orders.  
  461.  
  462. 
  463.  
  464. The prompt dialog when the query is submitted
  465.  
  466. Qualification Prompts provide a mechanism to create generalized query templates that you complete at the time the query is to be submitted.  There can be more than one qualification prompt in each query.  They can be used in many contexts in the query to achieve the results you want.  The value last used for a qualification prompt is remembered by GQL in the event you want to reuse the value in several related queries.
  467.  
  468.  
  469. Getting Started with System 7.0
  470.  
  471. This section is provided for those who are familiar with GQL and simply want to explore the Macintosh System 7.0 Specific Features.
  472.  
  473. Data Access Manager:  GQL supports use of the System 7.0 Data Access Manager Low Level Interface and Data Access Language extension.
  474.  
  475. Publish/Subscribe:  GQL/User allows executive buttons to publish query results.  (To edit existing buttons select Edit Mode from the Layout Menu). Once the publisher is created and the GQL document is saved, the linkage is maintained by GQL.  Each time that button is pressed, the query is issued and the Edition file is rewritten with new results.
  476.  
  477. Query Documents:  When you save a GQL query in a file GQL creates a Data Access Manager Query Document.  These query docs can be used by other applications that support the Data Access Manager High Level Interface.  At present the queries cannot contain qualification prompts.
  478.  
  479. Balloon Help:  GQL/User has Balloon help for all its menus and the data objects in the data model window.
  480.  
  481. AppleEvents:  GQL currently supports the required AppleEvents.
  482.  
  483. Publish/Subscribe (using GQL and Excel)
  484.  
  485. Query results are often most useful when they are exported from GQL into other Macintosh applications.  GQL supports export of query results in several ways.  Data can be selected in the Query Results window and copied into the clipboard. (All the data can be selected by choosing Select All from the Edit menu, or by pressing on the row count in the upper left part of the results window.)  From the clipboard the data can be pasted into any application (try the CMD-Shift-V power user paste).
  486.  
  487. Query results can be saved to a file.  The file can be read by most applications.  To save a results file select Save Results from the Results menu.  
  488.  
  489. Executive buttons can be set up to save results directly to a file, directly to another application through the clipboard, or to Publish an edition file that can be Subscribed to by other 7.0 savvy applications.  Lets see how the executive button feature can be set up with a specific application such as Excel.  
  490.  
  491. You must have Microsoft Excel 3.0 to run the next demonstration.
  492.  
  493. In the Finder locate the Pub/Sub Demo document.  Launch Excel by double-clicking on the Excel document labeled Pub/Sub demo.  This will open the Excel spreadsheet that has been set up for this demo.
  494.  
  495. When you first open the Pub/Sub Demo document the area designed for the subscriber information is already selected.  To select the edition file containing published information from GQL, choose Subscribe to... from the Edit menu (with the initial selection active).  You will see the dialog shown below.  Select Sales amounts from the GQL V3.0 Demo Folder and click the Subscribe button.  (If you now save the Pub/Sub demo document you won't have to do this setup again.)
  496.  
  497. 
  498.  
  499. The Excel Subscriber dialog
  500.  
  501. The resulting Pub/Sub Demo Excel worksheet is shown below.  If your Macintosh has enough memory you can run GQL and Excel at the same time.  This way you will be able to see the chart update automatically in Excel when an executive button is pressed in GQL.
  502.  
  503. 
  504.  
  505. The Pub/Sub demo screen
  506.  
  507. Leave Excel running and return to the GQL application.
  508.  
  509. Press the button with the icon of the bar chart on it.  
  510. 
  511. This button executes a query that retrieves selects all orders over a certain amount.  The button was specified to publish its results to an Edition file named Sales Amounts.  This is specified by the Publish operation in the Action Section of the button dialog.
  512.  
  513. You may be prompted for the name of the edition file.  If so, select Publish to OK the default name (Sales Amounts).
  514.  
  515.  
  516. 
  517.  
  518. Edition Manager Dialog
  519.  
  520.  
  521. The Excel document subscribes to the Sales Amounts edition file and uses the information to draw two charts.  Try the query with say $5000 and with $30000 as the minimum amounts.  You will see the charts automatically updated by Excel.
  522.  
  523. 
  524.  
  525. Charts created through the Executive Button facility
  526.  
  527. The effect of the executive button is to draw the appropriate chart.  Of course, each button can have a separate effect; customized to your requirements.
  528.  
  529. Other Features
  530.  
  531. This demo highlights the main features of GQL, but there are lots of other capabilities.  You can explore some of them by experimenting with the other menu items.  Some things you may discover are:
  532.  
  533. Aggregate functions (SUM, AVG etc)
  534. Grouping 
  535. Dynamic relationships
  536. Full/Short menus
  537. Combining qualifications
  538. Preferences
  539. Color Support (including preferences)
  540. Icon and PICT executive buttons and ornaments
  541. Annotations
  542. Submit query to file
  543. Results options
  544.  
  545. Things to try...
  546.  
  547. Reports:  from the results window you can generate formatted reports using commands from the Report Menu.  You must have selected Full Menus (from the Edit menu) and then choose Show Report from the Report menu.
  548.  
  549. Quick Select of Attributes:  with the cursor over a table object in the data model, press and hold the mouse button.  A pop-up list of attributes will be displayed for easy selection.
  550.  
  551. Form View:  in the results window you can double-click on any row number to switch into form view.  The form view shows all columns for a single row and allows you to step through the results one row at a time.
  552.  
  553. Large Column Display:  in the results window, long text strings can be truncated at the column boundary.  You can see the whole string by double-clicking a cell, an expanded view will be displayed.
  554.  
  555. Automatic Column Widths:  there is a check box in the column width dialog that will automatically resize columns to the largest size required for the current data.
  556.  
  557. Just remember that GQL is a very versatile tool.  It can be used by an experienced IS professional to create query environments for their end-users or themselves,  and it can be used by end-users that want access to the data but don’t have training with relational database concepts.  GQL can be customized to meet the different skill levels and requirements of different users.
  558.  
  559. Building GQL Data Models
  560.  
  561. You may be wondering where the data model document comes from?  The data models are created by the application GQL/Admin.  The task of building the data model for a user is usually done by a member of the IS staff who knows the structure of the database and who can customize the data model for their users.  GQL/Admin makes it very easy to add value to the database for the end-user.  By providing effective end-user access to corporate data the IS staff is freed from routine data requests and can concentrate on the more difficult tasks for which their specialized training and experience are of critical  importance.
  562.  
  563.  
  564. GQL - The Corporate Data Access Solution
  565.  
  566. GQL is the ultimate solution for corporate database access.  It enables end-users to access one of the corporation’s most valuable assets - information previously locked in corporate databases.
  567.  
  568. GQL supports the goals of Information Systems professionals who are striving to provide access to the corporate database.  It allows the IS staff to select the information to be presented to the users, and to take advantage of their specialized knowledge to create customized data models and EIS solutions for individuals or departments.  It helps you fulfill their mandate to provide  users with information, not just data.
  569.  
  570. The GQL tools provide significant productivity gains, both for end-users and for the IS staff that supports end-users.  GQL delivers a true win-win solution for progressive information-oriented organizations.
  571.  
  572. Appendix A
  573. The GQL Product Family
  574.  
  575. The GQL family of products includes GQL/User, GQL/Admin,  GQL/Design, and GQL/Update.
  576.  
  577. GQL/User provides decision makers with an intuitive and graphical view of database information customized to individual, department, or corporate needs. GQL's graphical approach to data access allows users to quickly locate, retrieve, or update information critical to their personal needs. All query results are displayed in a familiar spreadsheet format and can be stored locally on a Macintosh workstation.   This data can then be searched, sorted, or seamlessly integrated with other Macintosh applications, including word processors, presentation packages, and spreadsheets such as Excel or Wingz. GQL’s unique Executive Button facility allows organizations to create fully customized data access environments for the widest possible range of users. Using GQL, organizations are free to design user interfaces consisting entirely of Executive Buttons, as well as those containing customized database models for satisfying ad hoc query and reporting needs. GQL supports both Windows DDE facilities and Macintosh System 7 features.
  578.  
  579. GQL/Update is an extended version of GQL/User that allows users with special access privileges to perform data entry and table maintenance functions. 
  580.  
  581. GQL/Admin allows the database administrator, MIS personnel, or database application staff to develop flexible and sophisticated query environments for the widest possible range of users. 
  582. The administrator begins by loading the database schema directly from the host system in order to create the data objects used in the data model.  Using GQL/Admin, the administrator can rename data objects and attributes to make them more meaningful to users, as well as developing an attractive and intuitive layout of customized data models for use with GQL/User.  The administrator or application developer can also store predefined queries as Executive Buttons to provide users with database applications tailored to their needs.  And because GQL works transparently with popular programs such as Excel and Wingz, database application developers can use GQL/Admin to create sophisticated decision support systems that include integrated charting and data analysis capabilities. 
  583.  
  584. GQL/Design provides database designers with a rapid prototyping tool for creating new databases and data models for use in testing and developing sophisticated query applications. Using GQL's sophisticated graphical interface, the designer first creates the data model on the Macintosh, then generates the corresponding database tables on the host computer, or stores the create commands locally as a script file.  The resulting data model can then be used directly with GQL/User.  GQL/Design supports the entity relationship design method and includes built-in design checks.
  585.  
  586. Windows 3.0
  587.  
  588. GQL for Windows supports both the Dynamic Data Exchange (DDE) and Object Linking and Embedding (OLE) technologies of MS Windows 3.0 and later releases.  These advance data sharing and inter-application communication facilities allows developers to use GQL to create sophisticated office automation and decision support systems for a wide range of business, academic, and technical applications.
  589.  
  590. 
  591.  
  592.  
  593. Unix/Motif
  594.  
  595. GQL for Motif will support X/Windows OSF Motif on a variety of Unix platforms. As with GQL for Macintosh and Windows, Unix support will enable end users to share data models, query results, and reports quickly and easily.
  596.  
  597.